═══════════════════════════════════════════════════════════════════════════
                        WHATSDESK PRO - CHANGELOG
        AI-Powered Multilingual WhatsApp CRM - Version History
═══════════════════════════════════════════════════════════════════════════

ABOUT WHATSDESK PRO

WhatsDesk Pro is an AI-powered WhatsApp CRM that breaks language barriers in 
customer support. It combines intelligent ticket management with real-time 
translation in 100+ languages, multi-agent collaboration, and CRM capabilities.

Why I Created This Project:

I'm Mauro Gashfix. I created WhatsDesk Pro because businesses were struggling 
with international customer support on WhatsApp. Companies were losing customers 
due to language barriers, and existing solutions were either too expensive, 
too complicated, or unreliable.

I wanted to build something that actually works, is accessible to small and 
medium businesses, and combines all essential features in one system.

I'm offering this project for FREE to the community because I believe great 
customer service should be available to everyone, regardless of budget.

What Makes It Unique:
   - THE ONLY solution combining tickets + real-time AI translation
   - Multi-agent support with intelligent routing
   - Business hours automation with ongoing conversation support
   - Complete CRM features built specifically for WhatsApp
   - Professional-grade system, 100% FREE

Perfect For:
   - International support teams
   - E-commerce businesses serving global markets
   - SaaS companies with worldwide customers
   - Agencies managing multiple client accounts
   - Small businesses wanting to go global
   - Any business needing WhatsApp support in multiple languages

═══════════════════════════════════════════════════════════════════════════
VERSION 1.0.0 - Initial Release (November 2025)
═══════════════════════════════════════════════════════════════════════════

CORE FEATURES

Complete Ticket Management System
   - Open, assign, and close support tickets
   - Priority levels and automatic assignment
   - Full ticket history and statistics
   - Ticket preview in notifications
   - Client self-service ticket closure (/fechar ticket)
   - Supports multiple languages (pt, en, es, fr)
   - Agents notified when client closes ticket
   - Closure reason saved and displayed

Real-Time Conversations
   - Live chat between clients and agents
   - Agent transfer system with reason tracking
   - Automatic notifications and reminders
   - Timeout management for inactive tickets
   - Skip client feature (/pular, /skip, /saltar)
   - Ticket returns to queue with 'waiting' status
   - Agent notified if skipped client responds

Multi-Language Support (100+ Languages)
   - Automatic language detection by country code
   - Real-time translation using Google Cloud Translate
   - Clients and agents communicate in their native language
   - Configurable team language (DEFAULT_LANGUAGE in .env)
   - Bidirectional translation (Client <-> Team)
   - Original text always shown for reference
   - System messages respect team language setting

Professional Agent Management
   - Multiple agent support with individual statistics
   - Customizable agent names
   - Performance tracking (daily/weekly/monthly)
   - Active/inactive status control
   - Agent registration system
   - Statistics per agent

Smart Business Hours Management
   - Set your working hours and timezone
   - Respects ongoing conversations
   - Service continues outside hours if agent is attending
   - Only blocks new tickets outside business hours
   - Automatic out-of-office messages
   - Configurable business days

Media & File Support
   - Images, videos, audio, documents
   - Configurable file size limits
   - Media preview in notifications
   - Caption translation for media files
   - Secure file storage

Intelligent Notifications
   - New ticket notifications with preview
   - Skipped client response notification
   - Client closure notification with reason
   - Timeout alerts for pending responses
   - Transfer notifications
   - Business hours reminders

Database & Storage
   - SQLite database for reliability
   - Client information management
   - Complete message history
   - Ticket statistics
   - Notification tracking
   - Session persistence

Authentication
   - QR Code authentication
   - Phone Code via WhatsApp
   - Automatic session saving
   - Reconnection without re-authentication
   - Secure session storage


CONFIGURATION

.env Settings:
   - GOOGLE_PROJECT_ID - Google Cloud project
   - GOOGLE_APPLICATION_CREDENTIALS - Translation API credentials
   - BOT_NAME - Your bot's name
   - COMPANY_NAME - Your business name
   - DEFAULT_LANGUAGE - Team language (en, pt, es, etc.)
   - TIMEZONE - Your timezone
   - BUSINESS_HOURS_START - Opening time
   - BUSINESS_HOURS_END - Closing time
   - BUSINESS_DAYS - Working days (0-6)
   - ADMIN_NUMBERS - Agent phone numbers
   - TICKET_TIMEOUT_MINUTES - Unattended ticket alert
   - AGENT_RESPONSE_TIMEOUT_MINUTES - Agent reminder
   - CLIENT_RESPONSE_TIMEOUT_HOURS - Client inactivity timeout
   - DATABASE_PATH - Database file location
   - SESSION_NAME - WhatsApp session name
   - MAX_MEDIA_SIZE_MB - Maximum file size

Database Schema:
   - clients - Customer information
   - tickets - Support tickets with status tracking
   - agents - Agent management and statistics
   - messages - Complete conversation history
   - notifications - Notification tracking


AVAILABLE COMMANDS

Client Commands:
   - /open ticket - Open a new support ticket
   - /send - Send message to agent
   - /change language - Change preferred language
   - /fechar ticket - Close own ticket (pt)
   - /close ticket - Close own ticket (en)
   - /cerrar ticket - Close own ticket (es)
   - /fermer ticket - Close own ticket (fr)
   - /help - See available commands

Agent/Admin Commands:
   - /listar tickets - List all open tickets
   - /atender [ticket_id] - Attend to a specific ticket
   - /fechar ticket [ticket_id] - Close a ticket
   - /transfer [ticket_id] - Transfer ticket to another agent
   - /pular - Skip current client (pt)
   - /skip - Skip current client (en)
   - /saltar - Skip current client (es)
   - /stats - View statistics
   - /add agent - Register new agent
   - /remove agent - Deactivate agent
   - /help - See available commands
   - /adminhelp - See admin commands


TECHNICAL STACK

   - WPPConnect - WhatsApp Web connection
   - Google Cloud Translate - Real-time translation
   - Better-SQLite3 - Fast local database
   - Moment-timezone - Timezone management
   - Node.js v20+ - Runtime environment


DOCUMENTATION

Included Files:
   - READ THIS BEFORE USING.txt - Complete project overview
   - CHANGELOG.txt - This file
   - .env.example - Configuration template
   - package.json - Dependencies and scripts

Scripts:
   - npm start - Start the bot
   - npm run dev - Development mode with auto-restart
   - npm run prod - Production mode with PM2
   - npm run reset-session - Clear WhatsApp session
   - npm run reset-database - Recreate database


UX FEATURES

   - Instructions on how to close ticket shown to client
   - Formatted business days text
   - Clear command help messages
   - Multilingual command support
   - Translated system notifications
   - Preview in new ticket alerts
   - Clearer formatting throughout
   - Professional message templates


═══════════════════════════════════════════════════════════════════════════
ROADMAP - Future Ideas
═══════════════════════════════════════════════════════════════════════════

Potential Future Enhancements:

These are ideas for future development. Community feedback is welcome!

- Auto-close inactive tickets after timeout
- Analytics dashboard (response time, ticket stats)
- Ticket categories (Technical, Billing, etc.)
- FAQ auto-response system
- Internal notes on tickets
- Customer satisfaction ratings
- Scheduled messages
- Multi-channel support (Telegram, Email)

Want to contribute? Contact me on Discord: @maurogashfix


═══════════════════════════════════════════════════════════════════════════
KNOWN ISSUES
═══════════════════════════════════════════════════════════════════════════

Current Known Issues (v1.0.0):

- None reported yet.

If you find a bug or have suggestions, contact me on Discord: @maurogashfix


═══════════════════════════════════════════════════════════════════════════
CONTRIBUTORS
═══════════════════════════════════════════════════════════════════════════

Created by:
   - Mauro Gashfix (@maurogashfix)

Special Thanks:
   - WPPConnect Team - For the WhatsApp Web connection library
   - Google Cloud Platform - For translation API
   - Node.js Community - For the ecosystem
   - Everyone who uses and supports this project


═══════════════════════════════════════════════════════════════════════════
LICENSE
═══════════════════════════════════════════════════════════════════════════

(c) 2025 WhatsDesk Pro - Free & Open Project
Created by Mauro Gashfix

This project is provided FREE to the community.

You are free to:
   - Use it for personal or commercial purposes
   - Modify it to fit your needs
   - Share it with others

Please consider:
   - Giving credit to the original author (optional but appreciated)
   - Sharing your improvements with the community
   - Supporting the project if it helps your business

This is NOT a commercial product. It's a contribution to help businesses
grow globally without budget constraints.


═══════════════════════════════════════════════════════════════════════════

Last Updated: November 2025
Version: 1.0.0

Created by Mauro Gashfix
Discord: @maurogashfix

═══════════════════════════════════════════════════════════════════════════
